home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 676-700 / 680 / sattrack / reference.doc < prev    next >
Text File  |  1995-03-18  |  33KB  |  1,076 lines
  1. SatTrack Users Manual
  2.  
  3. =====================
  4.  
  5. ======================================================================
  6.  
  7. Copyright
  8.  
  9. ---------
  10.  
  11. SatTrack is keyware.  SatTrack may be freely redistributed without 
  12. change or modification.  It may be freely copied and distributed as 
  13. long as there is no charge above a nominal fee for media and copying.  
  14. SatTrack program and program files may not be  modified or changed for 
  15. personal use.  Please upload SatTrack, along with all files, to your 
  16. favorite BBS.  No  guarantee of any kind is given that the program(s) 
  17. described in this document are 100% reliable.  You are using this 
  18. material on your own risk.  SatTrack should not be modified.  SatTrack 
  19. is provided as key-ware, user registration is available.   
  20.  
  21.  
  22.  
  23. ======================================================================
  24.  
  25. Reference Manual
  26.  
  27. ----------------
  28.  
  29. This reference section provides information on all the menus, windows 
  30. and files associated with the SatTrack program.  The information is 
  31. ordered by the menu, window and file.   Much of the instructional 
  32. information within this section is repeated.  This is done to assist 
  33. the user in understanding the full effect of the command and how to 
  34. control the SatTrack program in the most efficient manner possible. 
  35.  
  36.  
  37.  
  38. ======================================================================
  39.  
  40. Menus
  41.  
  42. -----
  43.  
  44. The Menus are standard Amiga Menus.  They can be viewed by pushing and 
  45. holding down the right mouse button.  Most menu functions also have 
  46. keyboard hot-keys which are listed to the right of each menu function 
  47. item.  The hot key is listed below along with the menu item.   All hot 
  48. keys are used at the same time as the Right-Amiga-Key (RAK) as listed 
  49. below.  
  50.  
  51.  
  52.  
  53. ====================================================================== 
  54.  
  55. PROJECT
  56.  
  57. -------
  58.  
  59. The PROJECT MENU provides control of all file input and output as well 
  60. as system controls
  61.  
  62.  
  63.  
  64. Save Display (RAK-G   Graph)
  65.  
  66. ----------------------------
  67.  
  68. Selection of this menu option tells SatTrack you wish to save to a 
  69. file the current display as an IFF image.  Upon selection of this 
  70. menu, SatTrack presents the File Selection Window.  Through this 
  71. window you are able to select the file name that SatTrack will write 
  72. out the display.  Selection of either NEW or ADD will result in saving 
  73. of the graphic display to the file specified.   The colors saved with 
  74. the file are specified in the IFF file "SAVE_COLOR.IFF"  See the 
  75. SAVE_COLOR.IFF file reference for more information on the colors used 
  76. in the SAVE DISPLAY command.  Selection of the printer device will not 
  77. cause the graphics to be printed, you must use a paint program or the 
  78. Commodore DUMPGRAPHICS program.  
  79.  
  80.  
  81.  
  82. Save Keps DB (RAK-S   Save)
  83.  
  84. ---------------------------
  85.  
  86. Execution of this menu option causes SatTrack to save all satellite 
  87. information stored within its memory to a SatTrack Data base file.  
  88. Selection of this option causes SatTrack to open a File Selection 
  89. Window.  Using this window you are able to select the file where you 
  90. wish the SatTrack memory information to be saved.  After selecting a 
  91. file name you select either NEW or ADD.  NEW causes any information 
  92. within the Data base file to be written over by current data within 
  93. SatTrack.  Selection of ADD tells SatTrack to append the information.  
  94. Be careful that you don't result in a data base that contains more 
  95. that 300 satellites.  This is the maximum that SatTrack can handle.  
  96. SatTrack Data bases contain extra information that raw data files 
  97. don't contain.  Data bases contain all the information seen in the kep 
  98. edit window display. 
  99.  
  100.  
  101.  
  102. Load Keps DB (RAK-L   Load)
  103.  
  104. ---------------------------
  105.  
  106. Selection of the menu option informs SatTrack that the you wish to 
  107. load a previously saved kep data file.
  108.  
  109.  
  110.  
  111. The Load Keps menu item allow the user to select a previously saved 
  112. kep data base file and have it loaded into SatTrack.  (See FILE 
  113. SELECTION)  The user may select either NEW or ADD to cause the 
  114. database to be loaded.  Selecting NEW causes SatTrack to remove any 
  115. previously existing satellites to be removed before the data base file 
  116. is loaded into memory.  Selection of ADD causes SatTrack to append the 
  117. database information, leaving any existing satellite information in 
  118. memory.  ADD allows for merging of databases.  Remember that data 
  119. stored in memory is not written to file unless you do a Save Keps DB.
  120.  
  121.  
  122.  
  123. Input Keps (RAK-I Input)
  124.  
  125. ------------------------
  126.  
  127. Most satellite information that you will be able to find will be on 
  128. computer bulletin boards or other external sources that result in a 
  129. file.  This file can be read directly into SatTrack using the Input 
  130. Keps command.  Valid file requester selections are NEW and ADD.  NEW 
  131. causes any keps already in SatTrack memory to be delete before the 
  132. file requested is loaded, ADD causes SatTrack to append the file 
  133. information to any existing information in SatTrack memory.
  134.  
  135.  
  136.  
  137. There are two formats of satellite data that you will find from kep 
  138. sources.  One is called "NASA two line" format, the other is know as 
  139. the "ARRL format".  SatTrack is able to read both of these formats.  
  140. SatTrack allows these formats to be mixed so if you happen to capture 
  141. information in both formats, you need not separate them.  Most capture 
  142. sessions also contain information text that is not related to the 
  143. satellite information. (e.g. login information) SatTrack filters your 
  144. file, ignoring all extraneous information. 
  145.  
  146.  
  147.  
  148. Much effort went into making SatTrack understand the difference 
  149. between satellite information and other information, but if SatTrack 
  150. gets confused, you may need to edit out some of the non satellite 
  151. information.  
  152.  
  153.  
  154.  
  155. Print Keps (RAK-P Print)
  156.  
  157. ------------------------
  158.  
  159. The print keps menu option allow you to dump all the satellite 
  160. information to a human readable format.  The execution of this command  
  161. begins with a File Requester Window requests the user to select the 
  162. file name where the keps should be written.  The format of this file 
  163. is compatible to the Input Keps function.  This command can be used to 
  164. verify, backup or transfer your database to PC based tracking 
  165. programs.
  166.  
  167.  
  168.  
  169. About
  170.  
  171. -----
  172.  
  173. The about function displays information about the version and name and 
  174. address of the author of SatTrack.   
  175.  
  176.  
  177.  
  178. Quit
  179.  
  180. ----
  181.  
  182. The Quit menu option causes SatTrack to exit.  SatTrack will not  
  183. prevent you from quitting before saving kep information.  The QTH file 
  184. will be written out if you changed the QTH via the QTH menu option.
  185.  
  186.  
  187.  
  188. ====================================================================== 
  189.  
  190. EDIT
  191.  
  192. ---- 
  193.  
  194. The sub items under the EDIT item allows for user editing of the 
  195. particular date item.  See the windows section of this manual for 
  196. specific information on the sub-item.
  197.  
  198.  
  199.  
  200. QTH (RAK-Q QTH)
  201.  
  202. ---------------
  203.  
  204. The QTH is an amateur radio term for home.  The QTH window allows you 
  205. to enter your location in the world.  Your location in terms of 
  206. Latitude and Longitude and Altitude and your time-zone as a difference 
  207. from GMT.  See the QTH window section for more information.
  208.  
  209.  
  210.  
  211. Time (RAK-T Time)
  212.  
  213. -----------------
  214.  
  215. The Time window allows you to control the two tracking methods.  The 
  216. real-time tracking may be selected and a desired rate of satellite 
  217. update may be selected.  For simulation tracking you can select the 
  218. start and stop time as well as the update cycle.  See the Time Window 
  219. section for more information.
  220.  
  221.  
  222.  
  223. Keps (RAK-K Kep Satellite Edit)
  224.  
  225. -------------------------------
  226.  
  227. The Keps sub-item menu function causes SatTrack to enter the Satellite 
  228. editing window.  Satellite editing allows for viewing, adding, 
  229. modifying or deleting any of the satellites currently in SatTrack 
  230. memory. See the Kep Editing Window for more information.
  231.  
  232.  
  233.  
  234. ====================================================================== 
  235.  
  236. GLOBAL
  237.  
  238. ------
  239.  
  240. Each Satellite can be control independently of all other satellites in 
  241. SatTrack memory.  
  242.  
  243.  
  244.  
  245. This set of menu items allow for global control of all "radio-buttons"  
  246. and their operations.  These radio-button can be reviewed in the Kep 
  247. Edit Window function.  Sometimes the desire to change all the options 
  248. of one type is required.  These menu sub-items allow for the specified 
  249. operation to be done to all satellites in SatTrack memory.  The 
  250. alternative is to run EDIT KEPS and manually change each one.
  251.  
  252.  
  253.  
  254. Graph All On
  255.  
  256. ------------
  257.  
  258. Graph indicates that a particular satellite have its position plotted 
  259. on the world map display.  Selection of this sub-menu item causes all 
  260. of the satellite in SatTrack memory to plot on the world map display. 
  261.  
  262.  
  263.  
  264. Graph All Off
  265.  
  266. -------------
  267.  
  268. This item is the exact opposite of the Graph All On sub-item menu 
  269. function.  It causes all satellites in SatTrack memory to not plot on 
  270. the world map display. 
  271.  
  272.  
  273.  
  274. Print All On
  275.  
  276. ------------
  277.  
  278. Only satellites that have the Print indicator turned on will print to 
  279. the output file when that option is requested.  This sub-item  causes 
  280. all satellites in SatTrack memory to be set to be printed when 
  281. printing is enabled. 
  282.  
  283.  
  284.  
  285. Print All Off
  286.  
  287. -------------
  288.  
  289. This item is the opposite of Print All On sub-item menu function.  It 
  290. causes all satellites in SatTrack memory to not be printed if and when 
  291. printing is enabled.
  292.  
  293.  
  294.  
  295. Display All On
  296.  
  297. --------------
  298.  
  299. The display indicator allows for display of all SatTrack satellites in 
  300. memory.  The Display option control the text printout on the screen 
  301. for a satellite.   
  302.  
  303.  
  304.  
  305. Display All Off
  306.  
  307. ---------------
  308.  
  309. This option is the opposite of the Display All On.  It will turn 
  310. display of all satellites in SatTrack memory off.  
  311.  
  312.  
  313.  
  314. Visible All On
  315.  
  316. --------------
  317.  
  318. This option sets the visible option on for all satellites.  The 
  319. visible option has several functions depending on the state of other 
  320. menu options and the position of the satellite. 
  321.  
  322.  
  323.  
  324. Visible All Off
  325.  
  326. ---------------
  327.  
  328. This is the opposite of the Visible All On function.  Selection of 
  329. this sub-menu item will result in all satellites' visible option being 
  330. turned off.
  331.  
  332.  
  333.  
  334. ====================================================================== 
  335.  
  336. DISPLAY
  337.  
  338. -------
  339.  
  340. The DISPLAY menu item has sub-items which control the world map 
  341. display.  SatTrack can display the world map in three different center 
  342. points.  The center can be placed at either 0,90 East or 90 West 
  343. degrees.  This allows hemisphere of the user to be centered in the 
  344. display.  Selection of any of there items causes history tracking to 
  345. be erased.  
  346.  
  347.  
  348.  
  349. Redraw
  350.  
  351. ------
  352.  
  353. Redraw will simply redisplay the current selected map file, erasing 
  354. all satellite history points.
  355.  
  356.  
  357.  
  358. 0 Longitude (RAK-0 0 longitude)
  359.  
  360. -------------------------------
  361.  
  362. The 0 Longitude selection cause the map to be centered on the Prime 
  363. meridian.
  364.  
  365.  
  366.  
  367. 90E Longitude (RAK-E East longitude)
  368.  
  369. -----------------------------------
  370.  
  371. The 90E longitude selection causes SatTrack to select the Americas.  
  372. The display is centered on 90E longitude.
  373.  
  374.  
  375.  
  376. 90W Longitude (RAK-W West longitude)
  377.  
  378. ------------------------------------
  379.  
  380. The 90W longitude selection causes SatTrack to select the European to 
  381. Asian section of the Earth.  The display is centered on 90W longitude.
  382.  
  383.  
  384.  
  385. ====================================================================== 
  386.  
  387. ALARM
  388.  
  389. beep  (RAK-B Beep)
  390.  
  391. flash (RAK-F Flash)
  392.  
  393. -------------------
  394.  
  395. The Alarm sub-menu items interact with the Visible Options selection 
  396. for each satellite.  If a satellite is within line-of-sight of the 
  397. location stored in QTH, the satellite is said to be "visible".  When a 
  398. visible satellite has its Visible option turned on the display will 
  399. flash or a two tone sound will alarm.  The user can select from either 
  400. of these options with the FLASH and BEEP sub-menu item.  FLASH will 
  401. cause a screen flash and BEEP will cause the generation of sound in 
  402. the left and right speaker channels.
  403.  
  404.  
  405.  
  406. ====================================================================== 
  407.  
  408. PRINT  
  409.  
  410. Visible Only (RAK-V Visible Options)
  411.  
  412. Print File   (RAK-O Output Printfile)
  413.  
  414. -------------------------------------
  415.  
  416. The PRINT menu option is for control of the ASCII output.  Two sub-
  417. items exist for the PRINT menu.  The Visible Only file is linked with 
  418. the satellite VISIBLE OPTIONS variable for each satellite.  Visible 
  419. Only and the VISIBLE OPTIONS will print or not print the information 
  420. about the satellite.  
  421.  
  422.  
  423.  
  424. SatTrack has extensive control of when a satellite should be 
  425. controlled.  The control is via the PRINT FILE, VISIBLE ONLY and a 
  426. Satellite's PRINT SATELLITE and VISIBLE OPTIONS values.  Satellite 
  427. information will only be printed to a file, or printer when PRINT FILE 
  428. has been selected and a valid file has been selected.  Upon selection 
  429. of PRINT FILE, the standard file requester window will be displayed.  
  430. From this  window you can select the file or AmigaDOS device which to 
  431. sent the ASCII information.  SatTrack uses the VISIBLE ONLY and each 
  432. satellite's PRINT SATELLITE and VISIBLE OPTIONS to determine when to 
  433. print.  A table of this logical state is as follows:
  434.  
  435.  
  436.  
  437.     VISIBLE  |    A Satellite's      | Positive  |  Print
  438.  
  439.      ONLY    |  PRINT       VISIBLE  | Elevation |  Satellite
  440.  
  441.              |  SATELLITE   OPTION   |           |     ?? 
  442. ==================================================================
  443.  
  444.     *    OFF    *    *    N
  445.  
  446.     OFF    ON    *    *    Y
  447.  
  448.     ON    ON    ON    Y    Y
  449.  
  450.     ON    ON    ON    N    N
  451.  
  452.     ON    ON    OFF    N    N
  453.  
  454.  
  455.  
  456. In English, print the satellite if a print file is open, and the 
  457. satellites PRINT SATELLITE is on and either the VISIBLE ONLY is on, or   
  458. the VISIBLE OPTION is on and the satellite is positive.
  459.  
  460.  
  461.  
  462.  
  463.  
  464. ====================================================================== 
  465.  
  466. SCREEN    
  467.  
  468. To Back
  469.  
  470. -------
  471.  
  472. The SCREEN menu has only one sub-menu item, TO BACK.  Selection of 
  473. this sub-item causes the SatTrack screen to become the rear-most Amiga 
  474. screen.
  475.  
  476.  
  477.  
  478. All of SatTrack's editing can be performed using standard Amiga 
  479. windows.  
  480.  
  481.  
  482.  
  483. ======================================================================
  484.  
  485. License Window
  486.  
  487. --------------
  488.  
  489. The first window you will encounter is the License WINDOW.  If you 
  490. have not registered and installed your personal SatTrack keys, the 
  491. License WINDOW provides information about how to register.  Once you 
  492. have registered, the License WINDOW will present your information; 
  493. that is, your name, address and phone number.  To clear this window, 
  494. move the mouse pointer into the window and press the left mouse 
  495. button.  The window will disappear and you will now be in the running 
  496. SatTrack environment. 
  497.  
  498.  
  499.  
  500. ======================================================================
  501.  
  502. QTH Window     
  503.  
  504. Call Sign (or Name)
  505.  
  506. Altitude
  507.  
  508. UTC Offset
  509.  
  510. Latitude
  511.  
  512. East and West Radio Buttons
  513.  
  514. Longitude
  515.  
  516. North and South Radio Buttons
  517.  
  518. -----------------------------
  519.  
  520. Using the Right-Amiga-Key along with the Q key, you can select the QTH 
  521. window.  QTH is an amateur radio term for home-location.  Using the 
  522. QTH window you can enter information such as your HAM call sign (or 
  523. your first name if you are not a HAM).  
  524.  
  525.  
  526.  
  527. More importantly you need to enter your location on the earth.  This 
  528. location is described with longitude,latitude, altitude and the offset 
  529. from GMT.  Longitude and Latitude descriptions must also include a 
  530. direction on the compass.  
  531.  
  532.  
  533.  
  534. If you live above the equator, simple enter your Longitude as a 
  535. positive value.  If you happen to live below the equator you can 
  536. either enter the Longitude as a negative number or enter it as a 
  537. positive number and select the SOUTH radio button.  If you choose to 
  538. enter a negative value, SatTrack will change the value to positive and  
  539. select the SOUTH radio button.  Therefore after you enter your value 
  540. you can check your information by viewing the positive number along 
  541. with the SOUTH or NORTH radio button
  542.  
  543.  
  544.  
  545. SatTrack is "positive east", this means that Latitudes are entered as 
  546. positive values for the "Eastern" hemisphere and negative for the 
  547. "Western" hemisphere.  If you live in the United States you should 
  548. enter either a positive value or make sure that the EAST radio button 
  549. is selected.  If you live on the other side the prime meridian you 
  550. should enter the value as negative or positive and select the WEST 
  551. radio button
  552.  
  553.  
  554.  
  555. The UTC OFFSET is the final piece of information required to 
  556. completely describe your location on earth.  The UTC OFFSET should be 
  557. entered as the number of hours difference between your time-zone and 
  558. Universal Coordinate Time (UTC).  The times for some selected times 
  559. are: EST:5, EDT:6, CST:6, CDT:7, MST:7, MDT:8, PST:8, PDT:9.  If you 
  560. live east of latitude zero you should select a negative value.  A 
  561. value of zero will cause SatTrack to display all values for UTC time.
  562.  
  563.  
  564.  
  565. The final item in the QTH window is ALTITUDE.  The ALTITUDE is your 
  566. distance above "sea level" in meters. 
  567.  
  568.  
  569.  
  570. SatTrack will save these values when you exit, therefore unless you 
  571. need to change these values, you need not use the QTH window again.  
  572. Remember, however, make sure that you change the UTC OFFSET in the 
  573. event of daylight savings time.  
  574.  
  575.  
  576.  
  577. ====================================================================== 
  578.  
  579. Time Edit Menu    Time Selection Radio Buttons
  580.  
  581. Use Clock
  582.  
  583. In Month/Day
  584.  
  585. In Julian
  586.  
  587. Update Rate
  588.  
  589. Simulation Cycle Time
  590.  
  591. Simulation Start
  592.  
  593.   MM/DD/YY
  594.  
  595.   HOUR
  596.  
  597.   MINUTE
  598.  
  599.   YEAR
  600.  
  601.   DECIMAL DAYS
  602.  
  603. Simulation End
  604.  
  605.   MM/DD/YY
  606.  
  607.   HOUR
  608.  
  609.   MINUTE
  610.  
  611.   YEAR
  612.  
  613.   DECIMAL DAYS
  614.  
  615. Window Close
  616.  
  617. ------------
  618.  
  619. The Time Edit window allows many of the time controls within SatTrack.  
  620. SatTrack usually operates in real-time mode, where the Amiga time 
  621. clock is read and uses for tracking.  This is selected using the USE 
  622. CLOCK radio button.  SatTrack also has a "simulation" mode where you 
  623. can select a starting and ending time other than that of the clock.  
  624. This allows you to run tracking information at some time in the 
  625. future.  This is helpful for determining when the satellite you are 
  626. interested is visible.  Add this feature with other SatTrack features 
  627. such as the SAVE DISPLAY or PRINT FILE and you can generate and save 
  628. tracking information of future events. 
  629.  
  630.  
  631.  
  632. To simulate SatTrack tracking, there are two methods of entering 
  633. simulation times; one is using a standard day, month, year and hour, 
  634. minute time; the other is by using a year and Julian time.  
  635.  
  636.  
  637.  
  638. Julian time is a real number that represents the number of days since 
  639. the beginning of the year.  The fractional portion of the Julian time 
  640. is the hour, minute and seconds of the day.  For example, one second 
  641. into January first is 1.0000115, noon on Jan 1 would be 1.50000.  This 
  642. along with a year describe the START or STOP time.  Use the YEAR 
  643. DECIMAL DAYS gadgets of the START DATE AND TIME to select a start time 
  644. and the same gadget title under the END DATE AND TIME for  selection 
  645. of the stop time.  Usually you would know the JULIAN star and stop 
  646. date that you wished to run.
  647.  
  648.  
  649.  
  650. You can also run a simulation using the more standard date and time 
  651. format.   Select the IN MONTH/DAY radio button to indicate that you 
  652. wish to run in simulation mode using the MM/DD/YY HOUR MINUTE start 
  653. and stop time.  MM represents the numerical representation for the 
  654. month, January=1; February=2, etc.   The hour is entered as a number 
  655. from 0 to 23, minutes from 0 to 59.  Enter the START DATE AND TIME as 
  656. well as the END DATE AND TIME.
  657.  
  658.  
  659.  
  660. SatTrack will validate each gadget for valid values.  A single invalid 
  661. value will cause SatTrack to flash the display and clear out the 
  662. offending gadget.  Once all values are selected, click the close 
  663. gadget to start the simulation.  SatTrack will validate the completed 
  664. time and if it finds an error it will flash the screen again.  You 
  665. will have to re-enter the TIME WINDOW to correct your values, upon 
  666. entry to the TIME WINDOW, the mode will be reset to real-time as 
  667. indicated by the selected USE CLOCK radio gadget.
  668.  
  669.  
  670.  
  671. Two other gadgets exist on the TIME WINDOW.  These gadgets control the 
  672. rate at which SatTrack updates the satellite data.  The UPDATE RATE 
  673. gadget controls the approximate time for all satellites that you have 
  674. requested to be updated.  If you have only one satellite  selected and 
  675. a UPDATE RATE of 3 seconds, SatTrack will attempt to update the 
  676. satellite once every 3 seconds.  If you have 3 satellites and have the 
  677. UPDATE RATE value set at 3, SatTrack will attempt to update one 
  678. satellite every second.  Different Amiga processor will update at 
  679. different rates.  A 68030 w/ 68882 will fully update 60 to 80 
  680. satellites a second.  A value of 0 for UPDATE RATE will causes 
  681. SatTrack to attempt to operate at the fastest possible rate.  This is 
  682. usually preferred for simulation mode since the faster result is 
  683. usually desired.  For real-time mode, a value of zero will cause 
  684. SatTrack to update satellites as fast as possible, however the time 
  685. will not increment any faster than the Amiga clock time.
  686.  
  687.  
  688.  
  689. The final gadget on the TIME WINDOW is the SIMULATION CYCLE TIME. This 
  690. gadget allows you to select the time increment for simulation.  After 
  691. the completed cycle of all operable satellites, the value specified in 
  692. SIMULATION CYCLE TIME will be added to the current simulation time for 
  693. the next interation. 
  694.  
  695.     
  696. ====================================================================== 
  697.  
  698. Kep Edit Menu    
  699.  
  700. Satellite Specific Information
  701.  
  702. Satellite Name            
  703.  
  704. Catalog Number
  705.  
  706. Epoch Time
  707.  
  708. Element Set
  709.  
  710. Epoch Rev
  711.  
  712. Inclination
  713.  
  714. R. A. of Node
  715.  
  716. Eccentricity
  717.  
  718. Arg of Perigee
  719.  
  720. Mean Anomaly
  721.  
  722. Mean Motion
  723.  
  724. Decay Rate
  725.  
  726. Satellite Brush File
  727.  
  728. Frequency
  729.  
  730. Graph Color
  731.  
  732. DB Entry #
  733.  
  734. Display Satellite
  735.  
  736. Visible Options
  737.  
  738. Print Satellite
  739.  
  740. Graph Satellite
  741.  
  742. Selection Slide Bar
  743.  
  744. Satellite
  745.  
  746. Delete
  747.  
  748. New
  749.  
  750. ----------------------
  751.  
  752. The most commonly used window in SatTrack is the KEP EDIT WINDOW.  
  753. This window is used to enter, delete or modify the information that 
  754. describes the orbit of a satellite.  The orbital values are listed 
  755. below with a short description for your interest:
  756.  
  757.  
  758.  
  759. Satellite Name:  This is the name of the orbiting object, any name 
  760. less than 15 characters is acceptable.
  761.  
  762.  
  763.  
  764. Catalog Number:  This is a number assigned to the specific orbiting 
  765. object.  This number will always be the same for the same 
  766. object.
  767.  
  768. Epoch Time:  This it the time that the other information was created 
  769. for the orbiting object.  The time is in modified julian 
  770. in the format YYDDD.ddddddddddd where YY is the year, DDD 
  771. is the day of the year and ddddddddddd is the number of 
  772. hours, minutes, etc.
  773.  
  774.  
  775.  
  776. Element Set: a text string that describes the time that this kep set 
  777. was generated.  For example, for shuttles the first set 
  778. of information is JSC-001 for Johnson Space Center #1.  
  779. JSC released the information.  The element set is used to 
  780. help you determine the difference between different 
  781. measurements of the satellite.  Any text can be used 
  782. here.  
  783.  
  784. Epoch Rev: Rev for revolution.  This the the orbit number, or the 
  785. number of time the satellite circled the earth. 
  786.  
  787.  
  788.  
  789. Inclination:  the angle between the orbit and equatorial planes 
  790. measured in a plane perpendicular to a line defining the 
  791. respective intersection.
  792.  
  793.  
  794.  
  795. R. A. of Node: Right Ascension, The angle measured in the plane of the 
  796. equator from a fixed inertial axis in space (vernal 
  797. equinox), to a plane normal to the equator (meridian) 
  798. which contains the object.
  799.  
  800.  
  801.  
  802. Eccentricity: angle measured in the fundamental plane from the 
  803. principal axis to a meridian which contains at its remote 
  804. base point the outward projection (normal to principle 
  805. axis)  of the orbital object that circumscribes the 
  806. actual ellipse of motion.
  807.  
  808.  
  809.  
  810. Arg of Perigee: Argument of prefocus, The angel measured in the orbit 
  811. plane from the line defined by the longitude of the 
  812. ascending node to another line in the orbit plane, which 
  813. contains the focus and passes through perifocus.
  814.  
  815.  
  816.  
  817. Mean Anomaly: mean motion times the ephemeris time minus the time of 
  818. perifocal passage.
  819.  
  820.  
  821.  
  822. Mean Motion:  Gravitational constant times the square root of latitude 
  823. of the orbital object divided by semi-major axis raised 
  824. to the 3/2 power.
  825.  
  826.  
  827.  
  828. Decay Rate: or Drag; the effect of the drag on the satellite. 
  829.  
  830.  
  831.  
  832. Frequency: The frequency of the radio transmitter or receiver on the 
  833. satellite.  This values is used to calculate the doppler 
  834. effect causes by the movement of you and the satellite.
  835.  
  836.  
  837.  
  838. Some satellite information is not related to keplarian math.  These 
  839. items are for use of the SatTrack program and its 
  840. features.
  841.  
  842.  
  843.  
  844. GRAPH COLOR: is a color from 1 to 14 for the satellite to display for 
  845. the history point and the text display.  See the COLOR 
  846. FILE for more information.
  847.  
  848.  
  849.  
  850. DB Entry #: a non editable display of the numerical location of the 
  851. satellite in the database.
  852.  
  853.  
  854.  
  855. Display Satellite:  When this radio button is selected, SatTrack will 
  856. write the Satellites information on the screen as text at 
  857. the bottom of the display. 
  858.  
  859.  
  860.  
  861. Visible Options:  This radio button controls special functions that 
  862. operate based on whether the satellite is visible from 
  863. your QTH (location).  If the option is selected and the 
  864. satellite is visible it will cause the BEEP and FLASH 
  865. functions to sound or flash the screen at each update. 
  866. See the BEEP and FLASH menu items.   This button also 
  867. controls special print functions.  See the PRINT menu 
  868. option for more information.
  869.  
  870.  
  871.  
  872. Print Satellite: Selection of this radio button will cause SatTrack to 
  873. include this satellite in any printing activity.  This 
  874. button is used in conjunction with the PRINT menu items.  
  875. See the PRINT menu sub-items VISIBLE OPTION and PRINT 
  876. FILE. 
  877.  
  878.  
  879.  
  880. Graph Satellite: This radio button controls this graphing of the 
  881. satellite position on the world map.  Selection of this 
  882. item will cause SatTrack to graph the satellite on the 
  883. map.
  884.  
  885.  
  886.  
  887. NEW Satellite:  This button causes SatTrack to open a new location in 
  888. memory for you to enter manual satellite information.
  889.  
  890.  
  891.  
  892. DELETE Satellite: This button causes SatTrack to remove the currently 
  893. displayed satellite from memory.  The next satellite in 
  894.  
  895.  
  896.  
  897. ====================================================================== 
  898.  
  899. File Selection
  900.  
  901. Quick device and Directory Selection
  902.  
  903. Extension
  904.  
  905. Drawer
  906.  
  907. <
  908.  
  909. File/Directory List
  910.  
  911. File/Directory List Slide Bar
  912.  
  913. File Selection
  914.  
  915. NEW
  916.  
  917. ADD
  918.  
  919. DELETE
  920.  
  921. CANCEL
  922.  
  923. -------------------------------------
  924.  
  925. All submenu items that read or write to files (or printer) start 
  926. execution by displaying the FILE SELECTION window.  This window 
  927. contains many gadgets that allow for easy selection of file or 
  928. printer.  At the top of the window is the QUICK DEVICE AND DIRECTORY 
  929. SELECTION.  These gadgets contain the text DF0:, SAT: and DH0:.   DF0: 
  930. causes SatTrack to select the floppy device.  Selection of SAT: causes  
  931. selection of a user preselected AmigaDOS assign statement.  DH0: 
  932. allows for selection of a hard disk.   The EXT gadget defines the 
  933. default file type.  Each SatTrack FILE SELECTION window has a 
  934. preselected default file extension.  If you wish to select another 
  935. file extension, simply move the mouse to this gadget and click the 
  936. left mouse button.  Change the file extension to your choice.  If you 
  937. wish to see all files change the file extension to blanks.   The 
  938. DRAWER gadget is another way to select a directory or sub-directory.  
  939. A DRAWER can be entered by either selection of a directory in the 
  940. FILE/DIRECTORY LIST gadget or by selecting the DRAWER gadget and 
  941. typing your choice of directory.  The FILE/DIRECTORY LIST gadget is 
  942. centered on the FILE SELECTION window.  It contains a list of the 
  943. files that are contained in the specified DRAWER and match the EXT 
  944. text.  The FILE Selection gadget allows for entry of the particular 
  945. file to be processed.  
  946.  
  947.  
  948.  
  949. The NEW, ADD gadgets allow for execution of the file selection you 
  950. have already made.  Except for the SAVE DISPLAY sub-menu item, the NEW 
  951. and ADD gadgets have different functions.  ADD will cause an existing 
  952. file to be appended to by the information to be written.  The NEW 
  953. function will remove any existing information from the file before  
  954. the file is written.  Submenu items such as the LOAD KEPS or INPUT 
  955. KEPS that load a file into SatTrack memory will append to that memory 
  956. information with a ADD and delete old memory information with the NEW 
  957. gadget.
  958.  
  959. The DELETE gadget allows for deleting the file listed in the FILE 
  960. SELECTION gadget.  The CANCEL gadget will abort the execution of the 
  961. command you selected.  This is similar to the CLOSE WINDOW gadget.
  962.  
  963.  
  964.  
  965. ======================================================================
  966.  
  967. Screen Display
  968.  
  969. The SatTrack screen contains text information about the current 
  970. satellite.  The time is display at the bottom of the display.  This 
  971. time is either the real-time as in real-time mode or the simulation 
  972. time if SatTrack is operating in simulation mode.  The satellite 
  973. specific information include the Satellites Name, the orbit based on 
  974. the displayed time.  Also displayed is AZ for azmuth; this is the 
  975. direction. (North equals 0, East equals 90 degrees, South equals 180 
  976. degrees and West equals 270 degrees).  EL is the elevation of the 
  977. satellite to you, a positive value means the satellite is above the 
  978. horizon to you. Elevation is from zero at the horizon to 90 degrees if 
  979. the satellite is directly above you.  Range is the distance from you 
  980. to the satellite in Kmeters.  Height is the satellites altitude from 
  981. the ground below the satellite to the satellite, the units is also 
  982. Kmeters.  Lat and Long is the position of the satellite,  This is 
  983. displayed using a number and the letters (N,S,E and W)  SatTrack does 
  984. not display negative values,  The letter is used to eliminate any 
  985. confusion about which hemisphere is negative.  The United States is 
  986. mostly W for west and N for north.  Doppler is the offshift of the 
  987. satellites frequency (as entered in the KEP EDIT Window)  This off 
  988. shift is measured in a difference from the frequency in KHertz.  The 
  989. phase is the relative to the satellite. 
  990.  
  991. ======================================================================
  992. Graphics Files
  993.  
  994. 00M.iff
  995.  
  996. 90E.iff
  997.  
  998. 90W.iff
  999.  
  1000. display_color.iff (wrong name)
  1001.  
  1002. save_colors.iff
  1003.  
  1004. ----------------
  1005.  
  1006. Several files are required for SatTrack to operate properly.  These 
  1007. file must be stored in the same directory as the SatTrack program.
  1008.  
  1009. The files 00M.iff, 90E.iff and 90W.iff are Amiga IFF formatted 
  1010. graphics files.  These three files contain the world map displays seen  
  1011. with the DISPLAY menu commands.  If you wish you can edit these files 
  1012. to add any graphics that you wish, however do not move the location of 
  1013. the map information.  Movement of the map information will cause 
  1014. SatTrack to track improperly.
  1015.  
  1016. The display color.iff file and save_colors.iff files are used by 
  1017. SatTrack to allow you to define the colors uses for display and the 
  1018. SAVE DISPLAY sub-item menu command.  The colors in the 00M, 90E and 
  1019. 90W are not used by SatTrack.  The purpose of the display_color.iff 
  1020. file is to define the screen display colors.  The IFF file can be 
  1021. edited by using your regular paint program.  The file contains color 
  1022. boxes and text explaining the use of this color.  Through your paint 
  1023. program you can change the colors that SatTrack will use for display.  
  1024. The save_colors.iff file is similar to the display_color.iff file 
  1025. except the colors defined in this file is used when saving the display 
  1026. to a file using the SAVE DISPLAY command.   NOTE: Default colors 
  1027. selected for SatTrack were generated for minimal flicker for Amiga 
  1028. displays without video-enhancers.
  1029.  
  1030.  
  1031.  
  1032. ====================================================================== 
  1033.  
  1034. Program Files
  1035.  
  1036. SatTrack
  1037.  
  1038. SatTrack.info
  1039.  
  1040. --------------
  1041.  
  1042. The SatTrack and SatTrack.info files are a standard program and 
  1043. program execute file for SatTrack.
  1044.  
  1045.  
  1046.  
  1047. ======================================================================
  1048.  
  1049. SatTrack.lic
  1050.  
  1051. ------------
  1052.  
  1053. The SatTrack.lic file is a special file, specifically defined for each 
  1054. user.  You need this special file configured with your name and phone 
  1055. number to prevent SatTrack form ceasing to operate at some time in the 
  1056. future when the DEMO license file expires.  The DEMO license file also 
  1057. causes SatTrack to operate slightly off track of the actual satellite 
  1058. location.  Registration as a user will get you the keys you need to 1) 
  1059. Have unlimited upgrades to SatTrack when they become available. 2) 
  1060. Never have SatTrack expire. 3) Cause Sattrack to be completely 
  1061. accurate.  See the registration information in this document.
  1062.  
  1063.  
  1064.  
  1065. ======================================================================
  1066.  
  1067. iff.library
  1068.  
  1069. -----------
  1070.  
  1071. The iff.library a public domain library created by Christian A. Weber 
  1072. of Zurich/Switzerland.  Iff.library is provided to you along with all 
  1073. the documentation information provided in the original release.  Copy 
  1074. the iff.library file to your LIBS: directory before using SatTrack.
  1075.  
  1076.